Formáty souborů

Soubory generátorů obsahují strukturu stromu filtrů (graf filtrů) a používají příponu *.txg ("TexiGen Generator"). Jsou to textové soubory zakončené dvojicemi znaků CR/LF, s následující strukturou.

První řádek je identifikační. Obsahuje textový řetězec "TexiGen", za kterým za oddělovací mezerou následuje číslo verze programu vyjádřená v setinách. Tj. např. TexiGen verze 1.14 uloží text "TexiGen 114". Číslo verze se používá při importu - je-li detekována zastaralá verze, mohou se některé filtry při importu zkonvertovat na novou syntaxi (např. doplněním parametrů) nebo přejmenovat na rezervované jméno zastaralého filtru, aby byla i nadále zachována funkčnost importovaného generátoru.

TexiGen 116

Na dalších řádcích je informační text. Jsou to řádky začínající znakem # a mezerou. Vše, co následuje za # a mezerou, se zobrazí jako doplňující informace generátoru (zkratka Ctrl+F1).

# Button Image
# TexiGen texture generator, (c) Miroslav Nemecek

Za informačními řádky následují definice grafu filtrů. Na každém řádku je definován jeden filtr. Řádek začíná symbolickým jménem filtru, což je písmeno "F" následované číslem. Za jménem filtru následuje jméno třídy filtru. Další 2 parametry určují grafickou souřadnici filtru v ploše editoru, nejdříve souřadnice X a poté souřadnice Y. Souřadnice X se počítá zleva doprava a souřadnice Y shora dolů.

F4 FlipY -192 88 F2
F5 Box -376 -136 100 0 100 F4 0 0 -50 0 0 Linear 0
F7 Color -616 40 "Colorize" (159,190,193,255)

Za souřadnicemi následují parametry filtru, oddělené navzájem jednou mezerou. Parametrem je číslo představující hodnotu parametru (typicky v rozsahu 0 až 100) nebo to může být barva určená 4 hodnotami v rozsahu 0 až 255 představujícími barevné složky R, G, B a A, oddělenými čárkou bez mezer a ohraničenými na začátku a konci kulatou závorkou. Číselné údaje a barvy jsou navzájem zaměnitelné. Jsou-li všechny 3 složky RGB shodné a složka A má hodnotu 255, použije se číselný údaj, v opačném případě se použije barevný parametr.

Je-li na vstup filtru připojen výstup jiného filtru, obsahuje parametr text jména připojeného filtru. Vstupy typu gradient a křivka nemají bez připojeného filtru editovatelnou hodnotu a namísto toho obsahují text "Linear", který označuje implicitní lineární hodnotu.

V některých případech může být parametrem text - např. jméno filtru Color nebo cesta k souboru u filtru Image. V takovém případě je text ohraničen dvojitými uvozovkami.

Formát souboru parametrů a schránky

Při uložení vstupních parametrů generátoru se uloží soubor s příponou *.txp ("TexiGen Parameters"). Stejný formát mají i parametry varianty a filtru při uložení do schránky Windows. Je to jednořádkový textový soubor, obsahující parametry oddělené jednou mezerou. Parametrem může být číslo nebo barva vyjádřená 4 složkami RGBA v rozsahu 0 až 255 oddělené navzájem čárkou a ohraničené ze začátku a konce kulatými závorkami. Jsou-li všechny 3 složky RGB barvy shodné a je-li A složka barvy 255, uloží se namísto barvy číselná hodnota.

C:\TexiGen\img"hires\My_castle.tga (254,197,1,255) 60 0

U filtru Image může být parametrem text - cesta k obrázku. Na rozdíl od formátu souboru generátoru text cesty není ohraničen uvozovkami. Obsahuje-li cesta znak mezery, je nahrazen znakem podtržítka _. Obsahuje-li znak podtržítka _, je nahrazen znakem dvojitých uvozovek ". Znak dvojitých uvozovek není v cestě povolen. Je-li text prázdný, je nahrazen samotným znakem tečky.

Témata nápovědy